Obtains a handle to the GDevice structure for the video device with the greatest pixel depth.

GDHandle GetMaxDevice (
    const Rect *globalRect
);

Parameter descriptions

globalRect

A rectangle, in global coordinates, that intersects the graphics devices that you are searching to find the one with the greatest pixel depth.

function result

A handle to the device with the greatest pixel depth.

DISCUSSION

All existing GDevice structures are linked together in the device list. After using this function to obtain a handle to the current GDevice structure, your application can use the GetNextDevice function to obtain a handle to the next GDevice structure in the list.

SPECIAL CONSIDERATIONS

The GetMaxDevice function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)